Dodaj tekst stylowy

VB C#

using IronWord;
using IronWord.Models;
using IronWord.Models.Enums;

// Load docx
WordDocument doc = new WordDocument("document.docx");

// Configure text
Run textRun = new Run(new TextContent("Add text using IronWord"));
textRun.Style = new TextStyle()
{
	FontSize = 72,
	TextFont = new Font()
	{
		FontFamily = "Caveat"
	},
	Color = IronWord.Models.Color.Red,
	IsBold = true,
	IsItalic = true,
	Underline = new Underline(),
	Strike = StrikeValue.Strike,
};

Paragraph paragraph = new Paragraph();

// Add text
paragraph.AddChild(textRun);

// Add paragraph
doc.AddParagraph(paragraph);

// Export docx
doc.SaveAs("save_document.docx");

Imports IronWord
Imports IronWord.Models
Imports IronWord.Models.Enums

' Load docx
Dim doc As New WordDocument("document.docx")

' Configure text
Dim textRun As New Run(New TextContent("Add text using IronWord"))
textRun.Style = New TextStyle() With {
    .FontSize = 72,
    .TextFont = New Font() With {
        .FontFamily = "Caveat"
    },
    .Color = IronWord.Models.Color.Red,
    .IsBold = True,
    .IsItalic = True,
    .Underline = New Underline(),
    .Strike = StrikeValue.Strike
}

Dim paragraph As New Paragraph()

' Add text
paragraph.AddChild(textRun)

' Add paragraph
doc.AddParagraph(paragraph)

' Export docx
doc.SaveAs("save_document.docx")

Install-Package IronWord

Dodaj tekst stylowy

Funkcja "Add Style Text" w IronWord pozwala programistom na stosowanie różnych opcji formatowania tekstu podczas dodawania treści do dokumentu DOCX. Zapewnia szczegółową kontrolę nad wyglądem tekstu, taką jak określenie rodziny czcionek, rozmiaru, koloru oraz atrybutów stylu, takich jak pogrubienie, kursywa, podkreślenie i przekreślenie. Tworząc obiekt Run zawierający TextContent i przypisując TextStyle do Run, programiści mogą dostosować sposób prezentacji poszczególnych elementów tekstowych w dokumencie, zapewniając spersonalizowany wygląd.

Ta funkcja jest przydatna do dynamicznego generowania profesjonalnie sformatowanych dokumentów, takich jak raporty czy listy, gdzie konkretne sekcje wymagają odrębnych stylów. Klasa TextStyle umożliwia łatwą manipulację tymi atrybutami, pozwalając na proste i złożone stylizowanie w tym samym dokumencie.

Kluczowe punkty

Tworzenie stylizowanego elementu:
- Tworzony jest obiekt Run zawierający TextContent z pożądanym tekstem.
- Właściwość Style obiektu Run jest przypisywana do obiektu TextStyle w celu zastosowania formatowania.
Konfigurowanie TextStyle:
- FontSize: Ustawiany na poziomie TextStyle (nie wewnątrz Font) w celu określenia rozmiaru tekstu.
- TextFont: Zawiera właściwości czcionki, w tym FontFamily do wyboru kroju czcionki.
- Color: Określa kolor tekstu przy użyciu IronWord.Models.Color.
- IsBold i IsItalic: Właściwości logiczne dla formatowania pogrubieniem i kursywą.
- Underline: Dodaje styl podkreślenia do tekstu.
- Strike: Stosuje formatowanie przekreśleniem przy użyciu wyliczenia StrikeValue.
Dodawanie do dokumentu:
- Należy użyć metody AddChild, aby dodać stylizowany obiekt Run do akapitu (Paragraph).
- Akapit jest następnie dodawany do dokumentu za pomocą metody AddParagraph.

Wyjaśnienie kodu

Ten kod pokazuje, jak tworzyć i stylizować tekst w dokumencie DOCX za pomocą IronWord. Na początku inicjalizowany jest nowy obiekt WordDocument reprezentujący generowany dokument. Tworzony jest obiekt Run zawierający TextContent z ciągiem "Styled text example", a do obiektu Run przypisywany jest TextStyle w celu skonfigurowania wyglądu tekstu.

Obiekt TextStyle zawiera ustawienia rozmiaru czcionki na poziomie TextStyle (nie wewnątrz Font), rodziny czcionek skonfigurowanej za pomocą TextFont, koloru tekstu oraz formatowania pogrubieniem. Te ustawienia dostosowują, jak tekst pojawi się w finalnym dokumencie.

Po ostylowaniu obiektu Run metoda AddChild dodaje go do akapitu w dokumencie. Ta metoda wstawia stylizowaną zawartość do dokumentu Word w odpowiednim formacie. Na koniec wywoływana jest metoda SaveAs w celu wyeksportowania dokumentu jako "styled_document.docx". Wynikiem jest dokument Word, w którym wstawiony tekst jest sformatowany zgodnie z określonymi stylami, zachowując wszystkie właściwości czcionek i formatowania w pliku wynikowym.

Odkryj samouczki dotyczące elementów dokumentu, aby uzyskać więcej wskazówek dotyczących stylizacji.